home *** CD-ROM | disk | FTP | other *** search
/ TeX 1995 July / TeX CD-ROM July 1995 (Disc 1)(Walnut Creek)(1995).ISO / biblio / tib / INSTALL < prev    next >
Text File  |  1989-03-28  |  5KB  |  117 lines
  1. Tib installation
  2.  
  3. Tape: 9 track, 1600 6250 bpi, variable record length, 
  4.       unlabelled, block size 512 8000
  5.       ANSI (DEC File-11), labelled "tib", block size 2048
  6.  
  7. Source language: C
  8.  
  9. List of files attached at end.
  10.  
  11. There are four directories needed,
  12.     1. source listing directory,
  13.     2. macro directory,
  14.     3. documentation directory,
  15.     4. index directory.
  16.  
  17. It is suggested these be subdirectories of a directory `tib'.
  18. (Alternately they can all be the same directory.)
  19.  
  20. 1. Unpack the tar file into the directory tib.  For Unix, the script
  21. Unix-install ("sh Unix-install") will perform several of the following
  22. steps.
  23.  
  24. 2. With a text editor, change (once in each appropriate file except as noted):
  25.        a. tibdoc.tex --- A at top, B at top, C at top,
  26.        b. tib.man    --- A (5 times), B, C, E, F,
  27.        c. intro.tib  --- A (3 times),
  28.        d. tib.h      --- B (2 times), C, F,
  29.        e. Makefile   --- D (line 3).
  30.  
  31.    A. string AAAAA to name of documentation directory (absolute path),
  32.    B. string BBBBB to name of macro directory (absolute path),
  33.    C. string CCCCC to name of common-words file (absolute path),
  34.       (see 8 below, `common' is supplied common-words file),
  35.    D. string DDDDD to name of system bin directory (absolute path),
  36.    E. string EEEEE to name of source directory (absolute path),
  37.    F. string FFFFF to name of system index file (absolute path)
  38.       (see 12 below).
  39.       (Note: CCCCC and FFFFF are files; the others are directories.)
  40.  
  41. 3. Make certain paths to temporary files in  #define  statements
  42.    are correct in tib.h (they are set to /tmp/)  (there are
  43.    three of them).
  44.  
  45. 4. Make certain paths to system descriptions in  #include  statements
  46.    are correct in tibargs.c (#include <sys/types.h>, #include <sys/stat.h>).
  47.  
  48. 5. Move the following files to the documentation directory:
  49.    tibdoc.tex, intro.tib, test.tex, test.ref, Styles.
  50.  
  51. 6. Create tib.cat (`make manual') and install tib.man, tib.cat in
  52.    manual directories.  If desired, move tib.man and/or tib.cat to 
  53.    documentation directory.
  54.  
  55. 7. Move all files with extensions tib, ttz, ttx, to the macro directory.
  56.  
  57. 8. Move common to the index directory.
  58.  
  59. 9. Compile and link the programs.  Single command `make' should do it.
  60.    4 executables should result: tib, tibdex, tiblist, tiblook
  61.    (tiblook uses unix getopt; see instructions at beginning of source).
  62.  
  63. 10. Test
  64.        a. Make a test directory.  To it copy INDEX, test.tex and test.ref---
  65.           the last two from the documentation directory.
  66.        b. Run
  67.                          tib test.tex
  68.           This uses INDEX and should create a TeX file.
  69.           (If you get a "INDEX not up to date" message when you test tib, it 
  70.           is because tib is comparing the last modify dates of test.ref and 
  71.           INDEX (with chkindex). Just put INDEX in and out of a text editor 
  72.           (touch) to give it a new date.)
  73.           Run (plain) TeX on the output file as usual.
  74.        c. Run
  75.                          tiblook
  76.           Enter derham when it asks for you to enter something.
  77.           This also uses INDEX.
  78.        d. Run
  79.                          tiblist test.ref
  80.           Run plain TeX on the output.
  81.        e. Rename INDEX.  Run
  82.                          tibdex test.ref
  83.           The output of tibdex is a new INDEX which should be
  84.           identical to the one supplied for testing purposes.
  85.        f. If everything works, the directory can be discarded.
  86.  
  87. 11. Install the programs.  Command `make install' should do it.
  88.  
  89. 12. Change directory to index directory.  Install system reference
  90.     file.  Apply tibdex to this reference file.  If no system reference
  91.     file is to be used, create dummy index by applying tibdex to empty file.
  92.  
  93. 13. Clean up as desired (delete object files?).
  94.  
  95. 14. Advertise <documentation directory>/intro.tib to TeX users.
  96.  
  97. 15. Comments:
  98.        a. The siam format styles (siamd.tib, siamn.tib, siamdl.tib, 
  99.           siamnl.tib) contain options on fonts (SIAM specifies smaller 
  100.           type for bibliographies).  Check if you want to modify.
  101.        b. On some machines, the stack can overflow in locate.c from `refs'.
  102.           I believe making `refs' a global variable should not cause problems.
  103.           Put the line `struct reftype refs[MAXREFS]...' after the 
  104.           `static struct reftype' declaration.
  105.        c. In numo.tib and numos.tib, the font ammi10 is used.  For some
  106.           sites, this should be cmmi10.
  107.        d. Files ieeabb.ttz and ieefll.ttz are included, but not documented.
  108.           They consist of journal names and abbreviations for ieee journals.
  109.           They can be installed in the macro subdirectory and made available
  110.           with either the -i flag on the call to tib or by modifying .tib 
  111.           files.
  112.        e. A small unix utility named tibabb is included, but not documented.
  113.           It should be made executable and called as `tibabb <word>'.  
  114.           It will exhibit all entries in the journal file(s) containing 
  115.           that word, so that the appropriate definition code can be used.  
  116.           It should be modified to local use.
  117.